CRM da bLOw
O lugar para entender o que o CRM faz, como está sendo construído, onde está cada parte e quem o mantém funcionando.
1. Resumo rápido
O CRM reúne informações de clientes, histórico de contatos e tarefas da equipe de relacionamento em um só lugar. Nesta fase ilustrativa, o objetivo é substituir planilhas dispersas e dar contexto antes de cada atendimento. Será usado pelas equipes de relacionamento e operação; não é uma ferramenta aberta ao cliente.
| Pergunta | Resposta neste exemplo |
|---|---|
| Para que existe? | Consultar o histórico de um cliente e acompanhar o próximo contato sem depender de planilhas individuais. |
| O que já funciona? | Cadastro e busca de contatos no ambiente de teste. |
| O que vem a seguir? | Histórico de interações e atribuição de responsável por contato. |
| O que não faz agora? | Disparos automáticos de campanhas, previsão de vendas e decisões automatizadas por IA. |
2. Situação atual — atualizar toda semana
| Frente | Estado | Próximo passo | Dono no exemplo |
|---|---|---|---|
| Contatos e busca | Em teste interno | Validar busca por nome e e-mail com usuários internos. | Marina |
| Histórico de interações | Em desenvolvimento | Concluir gravação de notas e trilha de alterações. | Rafael |
| Permissões | Em desenho | Definir quem pode ver, editar e exportar dados. | Marina + operação |
| Lançamento | Não iniciado | Preparar treinamento e plano de suporte. | Operação |
Próximo marco ilustrativo: piloto com 5 pessoas da equipe de relacionamento em 15/10/2026. Bloqueio atual: regra de acesso a contatos sem responsável ainda precisa de decisão. Decisão necessária até: 30/09/2026. As datas só demonstram como registrar o andamento; não são compromisso da bLOw.
3. O que está dentro e fora
Dentro desta fase: contatos, busca, histórico de atendimento, responsável pelo contato, tarefas e permissões básicas. Fora desta fase: campanhas de marketing, integração financeira, pontuação automática de leads e IA que responda ou altere registros sem revisão humana. Mudanças de escopo devem apontar para um pedido aprovado, não aparecer silenciosamente nesta lista.
4. Como está sendo feito
Eventos de alteração seguem para um registro de auditoria. Integrações externas ficam isoladas na API; a interface não acessa serviços de terceiros diretamente.
O exemplo usa entregas pequenas: cada função passa por revisão de código, teste automatizado e teste com alguém da operação antes de chegar ao piloto. O quadro de trabalho mostra A fazer → Em desenvolvimento → Em revisão → Em teste → Pronto. A equipe registra decisões duradouras separadamente, com contexto e motivo, para que o próximo desenvolvedor entenda por que a solução foi escolhida.
| Parte | Responsabilidade | Estado |
|---|---|---|
| Interface | Telas de contatos, busca e tarefas; não guarda regras de permissão como única defesa. | Parcial |
| API | Validação, autorização, histórico e integrações. | Parcial |
| Banco | Contatos, interações, tarefas e trilha de auditoria. | Modelo em revisão |
| Jobs | Processos em segundo plano, como importação controlada. | Planejado |
5. Onde encontrar o trabalho no Git
Os caminhos a seguir são um exemplo de mapa, não links nem nomes de repositórios existentes. Na versão real, substituir por URLs de acesso interno, caminho exato, branch principal e pessoa responsável. Não colocar tokens, credenciais ou arquivos de ambiente nesta ficha.
| Onde procurar — exemplo | O que há lá | Manutenção |
|---|---|---|
crm-web/src/pages/contacts/ | Telas de lista e detalhe do contato. | Equipe de interface |
crm-api/src/modules/contacts/ | Regras e endpoints de contatos. | Equipe de API |
crm-api/src/modules/interactions/ | Histórico de atendimento e auditoria. | Equipe de API |
crm-api/db/migrations/ | Alterações versionadas do banco. | Revisão de engenharia |
crm-api/docs/adr/ | Decisões de arquitetura e alternativas consideradas. | Responsável técnico |
crm-api/README.md | Como preparar o ambiente, executar e testar localmente. | Quem alterar o setup |
Na ficha real, acrescentar: links dos repositórios, caminho dos pipelines, convenção de branches, arquivo de configuração de infraestrutura, local dos contratos da API e link para o quadro de tarefas. O README do Git ensina a executar o código; esta ficha oferece a visão geral e aponta para a fonte técnica.
6. Plataformas e integrações
| Uso | Escolha hipotética do exemplo | O que registrar na versão real |
|---|---|---|
| Código e revisão | GitHub | Organização, repositórios, responsáveis e regras de aprovação. |
| Desenho das telas | Figma | Arquivo canônico e responsável pelo design. |
| Interface e API | React/TypeScript e Node.js | Versões suportadas, serviços e comandos de execução. |
| Dados | PostgreSQL | Instância, dono, política de backup, retenção e acesso. |
| Entrega e monitoramento | GitHub Actions e Sentry | Pipelines, ambientes, painéis, alertas e acesso. |
| Documentação | Confluence + documentação no repositório | Qual página é oficial para cada assunto e quem mantém. |
Integrações externas do exemplo: importação inicial de contatos por arquivo aprovado; integração com atendimento ainda em análise. Na ficha real, listar origem e destino dos dados, quem é dono da integração, frequência, modo de falha e link do contrato. Se uma plataforma não estiver escolhida, escrever “a definir”, com dono e prazo, em vez de inventar uma escolha.
7. Dados, acesso e privacidade
O CRM pode conter dados pessoais e histórico de relacionamento. Cada perfil deve acessar somente o necessário para seu trabalho. Exportação, exclusão e alteração precisam de regras e trilha de auditoria. A ficha real deve apontar para a política aprovada de retenção, base legal, resposta a pedidos de titulares e tratamento de incidentes de dados — sem copiar dados de clientes para a documentação.
Pendente neste exemplo: definir matriz de permissões por função e prazo de retenção com as pessoas responsáveis por segurança e privacidade. Nenhuma dessas regras deve ser tratada como aprovada só por aparecer aqui.
8. Uso de IA — separar desenvolvimento e produto
| Tipo de uso | Situação ilustrativa | Controle necessário |
|---|---|---|
| Ajuda à equipe que constrói | Ferramentas de IA podem sugerir testes, explicações e rascunhos de documentação. | Revisão humana do código e dos textos; não inserir dados de clientes, segredos ou código sensível em ferramenta não aprovada. |
| IA dentro do CRM | Não está incluída nesta fase do exemplo. | Se for proposta, abrir escopo e avaliação própria: dados usados, fornecedor/modelo, custo, precisão, segurança, aprovação humana e opção de desligar. |
Na versão real, registrar quais ferramentas foram aprovadas, para que tarefas, com qual política de dados, quem autoriza e quando a decisão foi revisada. Não listar “usamos IA” sem explicar o que ela faz; também não afirmar que uma ferramenta é usada pela bLOw sem confirmação.
9. Ambientes, entrega e volta atrás
Exemplo: desenvolvimento local → ambiente de teste → piloto → produção. A publicação exige revisão, testes e migrações compatíveis. A página real deve ter links internos dos ambientes, pipeline de implantação, instruções de acesso, checklist de liberação e procedimento de rollback. Não publicar senhas nem URLs privadas de administração numa página aberta.
Antes do piloto, validar importação, permissões, restauração de backup e o que acontecerá com dados criados durante um rollback. A pessoa que autoriza a ida a produção e o horário de suporte da primeira semana devem estar escritos aqui.
10. Sustentação: quem cuida e como agir
| Situação | Primeira ação | Escalonamento no exemplo |
|---|---|---|
| CRM fora do ar | Verificar painel de disponibilidade e última publicação; abrir incidente. | Responsável técnico → infraestrutura → líder da operação. |
| Contato não aparece ou dado incorreto | Conferir filtros, origem e trilha de auditoria sem editar o banco manualmente. | Operação → equipe da API → privacidade, se houver dado pessoal afetado. |
| Importação falhou | Pausar nova importação, preservar arquivo e mensagem de erro com acesso restrito. | Equipe de API → dona da integração. |
| Suspeita de acesso indevido | Seguir o processo interno de incidente de segurança; restringir acesso e preservar evidências. | Segurança/Privacidade imediatamente. |
Na versão real, completar: canal de suporte, horário de atendimento, pessoa de plantão ou rota de escalonamento, painel de saúde, alertas, logs, instruções de rollback, runbooks e prazos de resposta acordados. No exemplo, esses contatos ainda não existem; não use esta tabela como runbook de produção.
11. Decisões, riscos e pendências
| Item | Estado | Responsável / registro |
|---|---|---|
| Guardar histórico de alterações de contato. | Decidido no exemplo; registrar contexto e alternativa no ADR-001. | Marina · crm-api/docs/adr/001-auditoria.md (caminho ilustrativo) |
| Permissões por perfil. | Aberto; bloqueia o piloto. | Marina + operação · decisão até 30/09/2026 (exemplo) |
| Importação com dados duplicados. | Risco; exige regra de reconciliação e teste. | Rafael · item do quadro a criar |
| Integração com atendimento. | Fora da fase atual; avaliar depois do piloto. | Produto · revisão após piloto |
Decisões importantes devem ter registro próprio e estável; quando uma decisão mudar, criar um novo registro que substitua o anterior e ligar os dois. A ficha resume e aponta para esses registros, sem esconder o histórico.
12. Rotina de atualização desta ficha
- Toda semana durante a construção: atualizar estado por frente, próximo marco, bloqueios, dono e data da revisão.
- A cada mudança técnica relevante: atualizar mapa do Git, plataformas, integrações, ambientes e link da decisão.
- Antes de produção: preencher sustentação, contatos, acessos, observabilidade, backup e rollback; obter revisão de quem vai operar o sistema.
- Depois do lançamento: revisar ao menos mensalmente e sempre após incidente, troca de responsável ou alteração de arquitetura.
Regra de manutenção: quem muda o sistema atualiza a parte afetada da ficha no mesmo trabalho; a pessoa responsável pela ficha confere se os links continuam válidos. Se uma informação ainda é desconhecida, marcar “a definir” com responsável e prazo. Não deixar uma data antiga parecer informação atual.
Fontes do formato
Esta ficha combina a orientação do GitHub para README e orientação de repositório, o registro de decisões de arquitetura descrito pela Microsoft e a atenção à operação e ao suporte do Google SRE. É uma adaptação para a necessidade da bLOw, não um formulário oficial dessas organizações.