Context Map do CRM
Propósito: Guia de rastreabilidade de impacto. Antes de alterar qualquer entidade, regra ou módulo, consulte a tabela correspondente para identificar todos os documentos que precisam ser revisados e atualizados.
Como usar
- Identifique o que será alterado na coluna esquerda.
- Revise todos os documentos listados na linha correspondente.
- Aplique as alterações necessárias em cada camada.
- Registre a mudança no
changelog/.
Mapa por Entidade de Domínio
| Entidade alterada | Domínio | Regras de Negócio | UI | API | Arquitetura |
|---|---|---|---|---|---|
| Usuário | dominio/usuario.md | regras-negocio/01_autenticacao.md | ui/01_autenticacao.md | apis/01_autenticacao.md | — |
| Tenant | dominio/tenant.md | regras-negocio/02_tenant.md | ui/02_tenant.md | apis/02_tenant.md | arquitetura/decisoes.md (item 1) |
| Time / Hierarquia | dominio/time.md | regras-negocio/03_hierarquia.md | ui/03_hierarquia.md | apis/03_hierarquia.md | arquitetura/decisoes.md (item 5) |
| Lead | dominio/lead.md | dominio/mapeamento.md | — | — | — |
| Cliente | dominio/cliente.md | dominio/mapeamento.md | — | — | — |
| Contrato / Proposta | dominio/contrato.md | dominio/mapeamento.md regras-negocio/08_planos.md | — | — | — |
| Planos e Serviços | — | regras-negocio/08_planos.md | ui/08_planos.md | apis/08_planos.md | — |
| Integrações | — | regras-negocio/05_integracoes.md | ui/05_integracoes.md | apis/05_integracoes.md | arquitetura/decisoes.md (item 4) |
| Tipos e Formatos | dominio/tipos-comuns.md | — | — | — | — |
Mapa por Área Transversal
| Área alterada | Documentos a revisar |
|---|---|
| Autenticação / Acesso | dominio/usuario.md, regras-negocio/01_autenticacao.md, ui/01_autenticacao.md, apis/01_autenticacao.md |
| Multi-tenant | dominio/tenant.md, regras-negocio/02_tenant.md, arquitetura/decisoes.md |
| Hierarquia e Visibilidade | dominio/time.md, dominio/usuario.md, regras-negocio/03_hierarquia.md |
| Funil de Vendas (Lead→Cliente→Contrato) | dominio/lead.md, dominio/cliente.md, dominio/contrato.md, dominio/mapeamento.md, jornadas/01_jornada_principal.md |
| Motor de Automação | arquitetura/decisoes.md (item 7), dominio/mapeamento.md |
| Comissionamento | arquitetura/decisoes.md (item 8), regras-negocio/03_hierarquia.md |
| Vistoria | arquitetura/decisoes.md (item 2), dominio/contrato.md, dominio/mapeamento.md |
| Base de Conhecimento | regras-negocio/04_base_conhecimento.md, ui/04_base_conhecimento.md, apis/04_base_conhecimento.md |
| DevOps / CI/CD (Docker & Pipeline) | arquitetura/padroes/devops-ci-cd.md, Dockerfile, nginx.conf, .gitlab-ci.yml, docker-compose.yml |
Regra de Ouro
Nenhuma camada é alterada isoladamente.
| Se alterar... | Verificar obrigatoriamente... |
|---|---|
Um campo em dominio/ | Se regras-negocio/ referencia esse campo com alguma restrição |
Uma regra em regras-negocio/ | Se ui/ precisa de nova validação e apis/ precisa de novo contrato |
Um endpoint em apis/ | Se dominio/ reflete o schema e arquitetura/ está alinhada |
Uma tela em ui/ | Se as validações da tela estão em regras-negocio/ |
Uma decisão em arquitetura/ | Se apis/ e dominio/ precisam ser atualizados |