Central de Docs - Guia prático para PMEs

O que é o MeuDISCPro?

É uma plataforma de inteligência comportamental baseada em DISC e IA que ajuda pessoas e gestores a tomar decisões melhores sobre gente. Para usuários individuais, entrega autoconhecimento e plano de ação. Para empresas, organiza recrutamento e desenvolvimento dentro do Painel Empresa.

Para quem é?

Para usuários individuais (B2C) e para empresas (B2B), principalmente PMEs que precisam decidir com rapidez sem um time grande de RH.

Como começar em 15 minutos

Escolha o caminho certo para seu contexto.

Usuario individual (B2C)

1. Comece pela avaliação em /avaliacao.
2. Escolha iniciar sem timer (ou com timer, se você quiser).
3. Conclua a avaliação e consulte o resultado no /empresa/meu-painel.
4. Use o Assistente Rhafael para transformar o resultado em ação prática.

Convidado por empresa

1. Use o link /convite/<token> enviado pelo gestor.
2. O convite pode chegar por e-mail, WhatsApp ou link direto: o token é o que valida o contexto.
3. Se o convite exigir timer, o CTA pode ser único.
4. Finalize a avaliação para registrar seu resultado no contexto da empresa.

Empresa (gestor/admin)

1. Cadastre a empresa em /empresa/cadastro.
2. Configure Fit Cultural e dados básicos em /empresa/configuracoes.
3. Convide por e-mail (disparo automático) ou gere link via WhatsApp/link direto (sem e-mail obrigatório), além de listas.
4. Organize o funil e use o Mentor BTOS no /empresa/dashboard.

Como funciona, sem jargão

Fluxo principal: avaliação DISC gera o perfil, a IA traduz o resultado e o gestor aplica em contratação, desenvolvimento e comunicação.

Bases da metodologia DISC

Se você quer entender a camada conceitual antes de usar a plataforma, estes são os pontos de entrada mais importantes do nosso domínio público.

• /o-que-e-disc: fundamento, limites e usos do modelo.
• /perfis-disc: leitura geral dos quatro estilos.
• /disc-em-equipes: aplicação em colaboração, comunicação e liderança.
• /disc-para-rh: uso em RH com criterio.
• /nossa-avaliacao: o que o relatorio entrega na pratica.

Status da plataforma

• B2C com entrada canônica em /avaliacao, resultado no /empresa/meu-painel e upgrade opcional do Relatorio Profissional.
• B2B com painel administrativo em /empresa/dashboard, dois funis (recrutamento e operacional) e configuracoes em /empresa/configuracoes.
• Planos B2B com segmentacao clara: Starter com Radar de Turnover, ate 3 gestores e departamentos mantidos no Kanban; Profissional com ate 10 gestores e analise por departamento com cerebro habilitado nas colunas.
• Portal de docs ativo em /docs, /docs/usuarios e /docs/empresas.
• Integrações e API: piloto controlado com audit/ping e webhooks inbound.
• Assistente Rhafael (conceitos) e Mentor BTOS (análise de equipe) com papéis distintos.

Integrações e API (piloto controlado)

Hoje a camada pública cobre somente dois fluxos:

• Audit ping: teste de conectividade para tokens ativos.
• Webhooks inbound: recebimento de eventos de parceiros.

Autenticação

• Audit ping: Authorization: Bearer <integration_token>
• Webhooks: X-Integration-Token: <integration_token>

Tokens e escopos

• O token de integração é criado por usuário admin autenticado da empresa.
• O segredo é exibido apenas uma vez na criação. Guarde com segurança.
• Depois, apenas o token_prefix fica visivel para identificacao.
• Escopos são validados quando presentes; tokens legados sem escopo continuam aceitos.

Endpoints públicos

• POST /api/integrations/audit/ping
• POST /api/integrations/webhooks/<provider>

Webhooks: assinatura

• Header obrigatório: X-Webhook-Signature (HMAC).
• Header opcional: X-Webhook-Id (quando ausente, o sistema gera delivery_id).
• Assinatura válida com o segredo INTEGRATIONS_WEBHOOK_SECRET (env).

Respostas e erros

• 200 OK (audit/ping) ou duplicado detectado (webhook).
• 202 Accepted (webhook persistido).
• 400 Provider inválido.
• 401 Token ausente/inválido ou assinatura inválida.
• 500 Webhook secret não configurado.

Não existe API pública de leitura de dados DISC ou de listagem de candidatos.

Duas IAs com papéis diferentes

• Assistente Rhafael: explica conceitos e ajuda no uso da plataforma.
• Mentor BTOS: aprofunda análises de equipe no contexto B2B.
• Limite importante: a decisão final continua sendo do gestor.

Visão institucional da proposta: /conheca-rhafael.

Tese e limites dessa abordagem: /manifesto.

Passo a passo rápido para usuários (B2C)

• Uso individual: /avaliacao.
• Convite de empresa: /convite/<token>.
• Use os CTAs Iniciar sem Timer ou Iniciar com Timer (quando o convite não exige timer, você escolhe).
• Apos concluir, acesse seus resultados no dashboard pessoal.

Passo a passo rápido para empresas (B2B)

• Cadastre a empresa em /empresa/cadastro.
• Admin da empresa opera em /empresa/dashboard.
• Gestão de membros e convites em rotas sob /empresa.
• Ajustes cadastrais, segurança e financeiro em /empresa/configuracoes.

Glossário rápido de RH para PME

• Fit cultural: alinhamento entre o jeito da pessoa trabalhar e a cultura da empresa.
• PDI (Plano de Desenvolvimento Individual): plano prático para evolução de competências.
• ATS: sistema para organizar vagas e candidatos no recrutamento.
• HRIS: sistema administrativo de RH (folha, ponto e rotinas burocráticas).
• 9-box e 360: métodos formais de avaliação de desempenho e potencial.
• OKR: método para definir objetivos e resultados-chave.

Roadmap de documentação (futuro)

• Busca interna no portal de docs.
• Versionamento/changelog de docs.
• Documentação pública da API e webhooks com exemplos.
• Guias filhos detalhados por tema para usuários e empresas.