Usar este modelo
Modelo para qualquer sistema, preenchido aqui com um CRM fictício. Pessoas, estágio, ferramentas, integrações e caminhos no Git abaixo são demonstrativos. Nenhum caminho é um repositório real da bLOw. Troque cada dado após confirmar com a equipe.
SYS-001 · Ficha Viva do Sistema · Exemplo: CRM

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.

EstadoEm construção
Responsável pela fichaMarina Souza, engenharia (exemplo)
Última atualização22 de setembro de 2026
Próxima revisão29 de setembro de 2026

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.

PerguntaResposta 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

FrenteEstadoPróximo passoDono no exemplo
Contatos e buscaEm teste internoValidar busca por nome e e-mail com usuários internos.Marina
Histórico de interaçõesEm desenvolvimentoConcluir gravação de notas e trilha de alterações.Rafael
PermissõesEm desenhoDefinir quem pode ver, editar e exportar dados.Marina + operação
LançamentoNão iniciadoPreparar 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

Pessoa da equipe → interface do CRM → API → banco de dados
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.

ParteResponsabilidadeEstado
InterfaceTelas de contatos, busca e tarefas; não guarda regras de permissão como única defesa.Parcial
APIValidação, autorização, histórico e integrações.Parcial
BancoContatos, interações, tarefas e trilha de auditoria.Modelo em revisão
JobsProcessos 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 — exemploO 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.mdComo 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

UsoEscolha hipotética do exemploO que registrar na versão real
Código e revisãoGitHubOrganização, repositórios, responsáveis e regras de aprovação.
Desenho das telasFigmaArquivo canônico e responsável pelo design.
Interface e APIReact/TypeScript e Node.jsVersões suportadas, serviços e comandos de execução.
DadosPostgreSQLInstância, dono, política de backup, retenção e acesso.
Entrega e monitoramentoGitHub Actions e SentryPipelines, ambientes, painéis, alertas e acesso.
DocumentaçãoConfluence + documentação no repositórioQual 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 usoSituação ilustrativaControle necessário
Ajuda à equipe que constróiFerramentas 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 CRMNã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çãoPrimeira açãoEscalonamento no exemplo
CRM fora do arVerificar 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 incorretoConferir filtros, origem e trilha de auditoria sem editar o banco manualmente.Operação → equipe da API → privacidade, se houver dado pessoal afetado.
Importação falhouPausar nova importação, preservar arquivo e mensagem de erro com acesso restrito.Equipe de API → dona da integração.
Suspeita de acesso indevidoSeguir 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

ItemEstadoResponsá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

  1. Toda semana durante a construção: atualizar estado por frente, próximo marco, bloqueios, dono e data da revisão.
  2. A cada mudança técnica relevante: atualizar mapa do Git, plataformas, integrações, ambientes e link da decisão.
  3. Antes de produção: preencher sustentação, contatos, acessos, observabilidade, backup e rollback; obter revisão de quem vai operar o sistema.
  4. 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.