Appearance
Implantar um novo cliente
Este checklist conduz a implantação desde a coleta de dados até o aceite. Execute os itens obrigatórios primeiro e só habilite módulos condicionais ou opcionais que façam parte do escopo contratado.
Responsáveis
- Sponsor do cliente: aprova processo, usuários e aceite.
- Responsável operacional: valida status, equipes, campos e rotina diária.
- Equipe de projetos: configura, registra evidências e conduz a homologação.
- Responsável técnico: prepara ambiente, e-mail, realtime, WhatsApp e outras integrações quando aplicável.
Antes de começar
Reúna:
- razão ou nome da empresa e segmento operacional;
- nome e e-mail do primeiro owner;
- moeda da operação: BRL, USD ou EUR;
- lista de usuários administrativos e respectivos perfis;
- funções, colaboradores e equipes;
- etapas reais dos projetos;
- campos adicionais obrigatórios;
- um cliente e um projeto fictícios ou autorizados para homologação;
- domínio e remetente de e-mail, se houver convite por e-mail;
- conta Meta e número do WhatsApp, se estiverem no escopo;
- responsáveis pelo aceite de cada módulo.
Não reúna senhas em planilhas ou mensagens. Cada usuário deve definir sua própria senha ou recebê-la por um canal seguro.
Visão rápida
| Fase | Obrigatoriedade | Resultado |
|---|---|---|
| 1. Ambiente | Obrigatória | Aplicação, banco, Redis, worker e scheduler operacionais |
| 2. Empresa | Obrigatória | Tenant criado com segmento e owner |
| 3. Dados iniciais | Obrigatória | Conteúdo de demonstração revisado ou removido conforme a política do projeto |
| 4. Pessoas | Obrigatória | Perfis, colaboradores e equipes configurados |
| 5. Operação | Obrigatória | Status, campos, cliente e projeto de homologação prontos |
| 6. Financeiro e RH | Condicional | Módulos administrativos configurados quando contratados |
| 7. Integrações | Condicional | E-mail, realtime, WhatsApp e flows validados quando contratados |
| 8. Aceite | Obrigatória | Evidências, pendências, responsáveis e entrega registrados |
1. Validar o ambiente
Antes do cadastro, confirme com o responsável técnico:
- URL correta do ambiente;
- HTTPS em homologação e produção;
- banco e Redis acessíveis;
- worker consumindo as filas esperadas;
- scheduler ativo;
- armazenamento público configurado para fotos;
- e-mail configurado se forem usados convites ou recuperação de senha;
- Reverb configurado se atualizações em tempo real fizerem parte do ambiente.
Não use APP_DEBUG=true, credenciais padrão ou serviços de desenvolvimento em produção.
2. Criar a empresa
- Abra o cadastro público da aplicação.
- Informe o nome da empresa, nome e e-mail do owner e uma senha válida.
- Escolha o segmento que mais se aproxima da operação.
- Revise os status e funções sugeridos; adicione itens necessários.
- Opcionalmente, cadastre colaboradores iniciais.
- Conclua o cadastro.
O sistema cria a empresa, atribui o perfil owner ao primeiro usuário e aplica o blueprint do segmento em uma única operação. O segmento não é alterável pela tela de configurações depois do cadastro; escolha com cuidado.
Veja Empresa e segmentos.
3. Revisar o conteúdo inicial
O blueprint cria dados de demonstração para ensinar o fluxo:
- status de projeto e funções de colaborador;
- um cliente e um projeto de exemplo;
- campos personalizados do segmento;
- uma atualização, uma ocorrência e um evento operacional;
- seis flows publicados, inicialmente desativados.
Abra cada área e confirme o que deve ser adaptado. Não trate os exemplos como dados reais. Antes da entrega ao cliente, remova ou identifique claramente tudo que continuar sendo demonstrativo.
4. Configurar pessoas e acesso
- Crie ao menos um segundo owner ou admin para contingência.
- Cadastre os demais usuários com o menor perfil necessário.
- Revise as funções profissionais.
- Cadastre colaboradores, contatos e situação ativa.
- Crie equipes de campo e de escritório.
- Associe colaboradores às equipes.
- Conceda acesso aos colaboradores que usarão o sistema.
- Vincule equipes de campo aos projetos corretos.
Use a matriz de usuários e permissões e o tutorial de equipes, colaboradores e campo.
5. Configurar a operação
- Ajuste os status para refletir o processo real e marque corretamente as etapas finais.
- Crie ou ajuste campos personalizados.
- Cadastre o cliente de homologação.
- Crie um projeto, atribua status e equipes.
- Publique uma atualização com foto.
- Registre uma ocorrência.
- Agende um evento operacional.
- Abra o link do portal em uma sessão anônima e envie um comentário de teste.
- Acesse como operador de campo e confirme a visibilidade do projeto.
6. Configurar módulos condicionais
Somente quando fizerem parte do escopo:
- categorias, contas a pagar/receber e fluxo de caixa;
- perfis de remuneração, adiantamentos e folha;
- credenciais e integrações externas;
- WhatsApp e roteamento de conversas;
- flows adicionais ou adaptação dos modelos publicados.
Teste cada integração antes de ligá-la a uma automação de produção.
7. Preparar operação e suporte
- Defina quem cria usuários, status, campos, credenciais e flows.
- Registre responsáveis por operação, financeiro, RH e integrações.
- Combine o canal de suporte e quais evidências devem acompanhar um chamado.
- Explique como pesquisar esta wiki por tela, conceito ou sintoma.
- Oriente a proteção de links de portal, webhooks e credenciais.
8. Homologar e obter aceite
Execute o roteiro de homologação e aceite. Registre ambiente, data, responsável, evidência, resultado e pendência de cada item.
Como validar a implantação
A implantação básica está utilizável quando:
- owner e usuário operacional entram no ambiente;
- cada perfil vê apenas as áreas esperadas;
- cliente e projeto podem ser criados;
- equipe de campo vê o projeto atribuído;
- atualização, ocorrência e evento aparecem nas áreas corretas;
- o portal exibe somente o projeto do link;
- worker e scheduler processam tarefas;
- módulos opcionais contratados possuem testes próprios concluídos.
Erros comuns
- Segmento incorreto: não tente corrigir apenas nomes isolados; confirme com a equipe responsável como recriar ou migrar o tenant.
- Convite não chega: valide primeiro o serviço de e-mail e permita redefinição de senha segura.
- Operador cai na tela de campo: isso ocorre quando o usuário operator está ligado a colaborador de equipe do tipo campo.
- Projeto não aparece no campo: associe ao projeto a mesma equipe do colaborador.
- Flow publicado não executa: além da publicação, o flow precisa estar ativo e o worker precisa processar a fila.