Central de Docs - Guia pratico para PMEs

O que e o MeuDISCPro?

E uma plataforma de inteligencia comportamental baseada em DISC e IA que ajuda pessoas e gestores a tomar decisoes melhores sobre gente. Para usuarios individuais, entrega autoconhecimento e plano de acao. Para empresas, organiza recrutamento e desenvolvimento dentro do Painel Empresa.

Para quem e?

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

Como comecar em 15 minutos

Escolha o caminho certo para seu contexto.

Usuario individual (B2C)

1. Comece pela avaliacao em /avaliacao.
2. Escolha iniciar sem timer (ou com timer, se voce quiser).
3. Conclua a avaliacao e consulte o resultado no /empresa/meu-painel.
4. Use o Assistente Rhafael para transformar o resultado em acao pratica.

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 e o que valida o contexto.
3. Se o convite exigir timer, o CTA pode ser unico.
4. Finalize a avaliacao para registrar seu resultado no contexto da empresa.

Empresa (gestor/admin)

1. Cadastre a empresa em /empresa/cadastro.
2. Configure Fit Cultural e dados basicos em /empresa/configuracoes.
3. Convide por e-mail (disparo automatico) ou gere link via WhatsApp/link direto (sem e-mail obrigatorio), alem de listas.
4. Organize o funil e use o Mentor BTOS no /empresa/dashboard.

Como funciona, sem jargao

Fluxo principal: avaliacao DISC gera o perfil, a IA traduz o resultado e o gestor aplica em contratacao, desenvolvimento e comunicacao.

Bases da metodologia DISC

Se voce quer entender a camada conceitual antes de usar a plataforma, estes sao os pontos de entrada mais importantes do nosso dominio publico.

• /o-que-e-disc: fundamento, limites e usos do modelo.
• /perfis-disc: leitura geral dos quatro estilos.
• /disc-em-equipes: aplicacao em colaboracao, comunicacao e lideranca.
• /disc-para-rh: uso em RH com criterio.
• /nossa-avaliacao: o que o relatorio entrega na pratica.

Status da plataforma

• B2C com entrada canonica 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.
• Portal de docs ativo em /docs, /docs/usuarios e /docs/empresas.
• Integracoes e API: piloto controlado com audit/ping e webhooks inbound.
• Assistente Rhafael (conceitos) e Mentor BTOS (analise de equipe) com papeis distintos.

Integracoes e API (piloto controlado)

Hoje a camada publica cobre somente dois fluxos:

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

Autenticacao

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

Tokens e escopos

• O token de integracao e criado por usuario admin autenticado da empresa.
• O segredo e exibido apenas uma vez na criacao. Guarde com seguranca.
• Depois, apenas o token_prefix fica visivel para identificacao.
• Escopos sao validados quando presentes; tokens legados sem escopo continuam aceitos.

Endpoints publicos

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

Webhooks: assinatura

• Header obrigatorio: X-Webhook-Signature (HMAC).
• Header opcional: X-Webhook-Id (quando ausente, o sistema gera delivery_id).
• Assinatura valida com o segredo INTEGRATIONS_WEBHOOK_SECRET (env).

Respostas e erros

• 200 OK (audit/ping) ou duplicado detectado (webhook).
• 202 Accepted (webhook persistido).
• 400 Provider invalido.
• 401 Token ausente/invalido ou assinatura invalida.
• 500 Webhook secret nao configurado.

Nao existe API publica de leitura de dados DISC ou de listagem de candidatos.

Duas IAs com papeis diferentes

• Assistente Rhafael: explica conceitos e ajuda no uso da plataforma.
• Mentor BTOS: aprofunda analises de equipe no contexto B2B.
• Limite importante: a decisao final continua sendo do gestor.

Visao institucional da proposta: /conheca-rhafael.

Tese e limites dessa abordagem: /manifesto.

Passo a passo rapido para usuarios (B2C)

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

Passo a passo rapido para empresas (B2B)

• Cadastre a empresa em /empresa/cadastro.
• Admin da empresa opera em /empresa/dashboard.
• Gestao de membros e convites em rotas sob /empresa.
• Ajustes cadastrais, seguranca e financeiro em /empresa/configuracoes.

Glossario rapido de RH para PME

• Fit cultural: alinhamento entre o jeito da pessoa trabalhar e a cultura da empresa.
• PDI (Plano de Desenvolvimento Individual): plano pratico para evolucao de competencias.
• ATS: sistema para organizar vagas e candidatos no recrutamento.
• HRIS: sistema administrativo de RH (folha, ponto e rotinas burocraticas).
• 9-box e 360: metodos formais de avaliacao de desempenho e potencial.
• OKR: metodo para definir objetivos e resultados-chave.

Roadmap de documentacao (futuro)

• Busca interna no portal de docs.
• Versionamento/changelog de docs.
• Documentacao publica da API e webhooks com exemplos.
• Guias filhos detalhados por tema para usuarios e empresas.